home *** CD-ROM | disk | FTP | other *** search
/ GFX Sensations 1 / Graphic Sensations - Volume 1.iso / com_net / bbs / 4dbbsd / docs / text / 05.message_bases < prev    next >
Encoding:
Text File  |  2000-01-01  |  35.2 KB  |  719 lines

  1. Chapter 5:  Message Bases
  2.  
  3.  
  4.  
  5.  
  6. 5.1 Introduction and Overview
  7.  
  8.     The message bases are normally the heart of a BBS.  They allow users
  9. to send messages between each other in private, and also join public
  10. discussions with multiple people involved.  Not only can the message bases
  11. be just local, but they can also be linked into networks spanning all over
  12. the world.
  13.  
  14.     With respect to networks, 4D-BBS does not have a Fido-Net compatible
  15. tosser or frontend.  There are many freely available public domain and
  16. shareware packages for you to choose from.  This documentation will explain
  17. how to setup 4D-BBS to interact with these packages, but will not explain
  18. how to setup the actual tosser/mailer itself.  It is assumed that you have
  19. already setup the tosser/mailer before you setup 4D-BBS.  You can setup
  20. 4D-BBS before setting up the tosser/mailer, but you will most likely have
  21. to reconfigure many parts of the BBS afterwards.
  22.  
  23.     Support of UseNet is accomplished by using the Amiga UUCP package.
  24. Again, it is assumed you have this package setup AND operable.  The UUCP:
  25. and UUMAIL:  assigns must be used for support of this package.  (Refer to
  26. Chapter 14 for more information on network specifics.)
  27.  
  28. 5.1.1 Getting Started
  29.  
  30.     Setting up the message bases requires thorough planning before
  31. execution to prevent errors.  You must first determine if you want to have
  32. networked sub-boards.  It is usually a good idea to keep your local
  33. sub-boards at the front of the list, and your networked sub-boards at the
  34. rear of the list.  Mixing the lists can be very confusing to users.
  35.  
  36.     There are several different types of sub-boards:  Mail, NetMail, Local
  37. sub-boards, echos, and Newsgroups.
  38.  
  39. 5.1.2 Mail and NetMail
  40.  
  41.     Sub-board number 0 is always the E-Mail (private) sub-board.  This
  42. allows users to send mail to each other without others (aside from the
  43. SysOp and the mail addressee) being able to read the mail.  In a Fido-Net
  44. network, Sub-Board 0 can also be used for Network Mail (NetMail).  A piece
  45. of mail which does NOT have a destination address will be considered local
  46. ONLY, while a piece of mail WITH a network address will be prepared to be
  47. sent out the network (by the tosser).  There can be MULTIPLE NetMail
  48. sub-boards setup, and you DO NOT have to make Sub-Board 0 a NetMail
  49. sub-board.  If you wish to control which users can send NetMail, but want
  50. all to be able to send local mail, then making sub-board 1 a NetMail
  51. sub-board can accomplish this.
  52.  
  53.     For InterNet style mail, you must setup a SEPARATE sub-board with the
  54. "I" flag set.  This will be the sub-board users can read and write
  55. AmigaUUCP style NetMail messages on (RFC-822 compatible message format).
  56. To accomplish this, sendmail from AmigaUUCP must be operable, and found in
  57. the "UUCP:C" directory.  The directory name associated with this sub-board
  58. WILL NOT be used.  Instead "UUMAIL:" from the Amiga UUCP package will be
  59. used.  When a user checks for mail waiting for them on this sub-board,
  60. "UUMAIL:" is scanned for a file name which matches the user's UUCP name.
  61. Sendmail will handle directing mail to the proper areas, and the
  62. "UULIB:Aliases" file is applicable to names used in this sub-board.
  63.  
  64. 5.1.3 Local Sub-Boards, Echos, and Newsgroups
  65.  
  66.     A sub-board in 4D-BBS is ANY message area.  A Local sub-board is a
  67. PUBLIC sub-board which is not networked.  This is normally the majority of
  68. the sub-boards, unless heavy networking is involved.
  69.  
  70.     An "echo" is the term referred to a networked, public sub-board in
  71. Fido-Net.  The term arises because any messages which are posted to an echo
  72. is actually "echoed" to many other sites which have also elected to carry
  73. the particular echo.  The name of an echo in Fido-Net can be anything you
  74. wish, since echos work on a "tag name" concept which are independent of the
  75. sub-board name.  The directory which you assign to this sub-board will be
  76. the link between the tosser and 4D-BBS.  You will also be able to assign an
  77. address that is independent of all other sub-boards to the echo to support
  78. multiple networks.
  79.  
  80.     A "Newsgroup" is the term given to an echo in UseNet.  Newsgroups are
  81. name dependent, so the name of the sub-board is VERY IMPORTANT and must be
  82. given exactly.  Normally names are a series of smaller parts put together
  83. with periods (i.e.  "Comp.Sys.Amiga.Datacomm").  Case is not significant in
  84. the name as 4D-BBS will return the name into all lowercase before
  85. processing it.
  86.  
  87.     User's access to a sub-board can be controlled by granting them either
  88. NO access, READ only, WRITE only, or BOTH read and write.  These options
  89. are configurable in both the Message Base and User Editor.
  90.  
  91. 5.2 The Message Base Editor:  MB_ED
  92.  
  93.     The Message Base Editor can be either run from the WorkBench by double
  94. clicking on its icon, or via a CLI by typing its name.  From 4D-BBS the
  95. editor can be accessed by using the ":Y" menu command or by using the FIFO
  96. door menu command (i.e.  "M:c F MB_ED").  You can access the Message Base
  97. Editor from a CLI, the pull-down menu or the Workbench.  You may have to
  98. adjust the size of the window in order to see everything being displayed.
  99.  
  100. 5.2.1 The Main List Screen
  101.  
  102.     Once the message base editor is executed, the main list screen
  103. appears.  This is a short, quick listing of the most important attributes
  104. of each sub-board.  From left to right they are:  sub-board number, name,
  105. maximum number of messages, start and stop times, number of total hours
  106. open, low and high messages, default new and member user's access,
  107. sub-board flag, and network address.
  108.  
  109.     At the main list screen, you can enter the number of a sub-board to
  110. examine and edit the attributes of the sub-board.  If there are more than
  111. 12 sub-boards, you can go to the next list by pressing Return or "n".  You
  112. can go directly to the top or bottom of the list by pressing "t" (top) or
  113. "b" (bottom).  You may also delete a sub-board directly from this menu with
  114. the "d" key, or load in different data files, with the "r" key.
  115.  
  116.     If you wish to save the changes you have made, select "s" from this
  117. menu.  Your changes will be saved, and you will be asked if you want to
  118. "Save Current access levels to user defaults".  This will make the new user
  119. and member access fields of this data file the DEFAULT access levels for a
  120. new user and a member when first validated.  If this is your primary set of
  121. sub-boards, you will normally say YES to this question.  If this is an
  122. alternate set of sub-boards, you will normally want to respond NO to this
  123. question.  For more information on multiple sets of sub-boards see the
  124. later discussion in section 5.3.
  125.  
  126. 5.2.2 Detail Edit Screen
  127.  
  128.     Once you enter the number of a sub-board to edit, a new screen will
  129. appear.  This allows you to edit the attributes of a certain sub-board.
  130. Below is a description of each option.
  131.  
  132.     Name The name of the Sub-Board.  The name of the sub-board can be
  133. whatever you wish, except for the previously noted case for a UseNet
  134. newsgroup.  Maximum length of a sub-board name is 34 characters.
  135.  
  136.     Path The path of a sub-board is where the messages for this sub-board
  137. should be stored.  This path MUST BE UNIQUE in comparison to all other
  138. sub-boards.  This can also be anything you wish, and does not have to
  139. follow any patterns.  The default is "Boards:Board_#", where "#" is the
  140. number of the sub-board.  This was carried over from version V1.65 or prior
  141. of 4D-BBS.  For a UseNet Newsgroup, this path is normally of the pattern
  142. "UUNews:Comp.Sys.Amiga.Datacomm" for versions earlier than 1.16 of UUCP and
  143. "UUNews:Comp/Sys/Amiga/Datacomm" for V1.16+.  The maximum length of the
  144. path can be 68 characters.
  145.  
  146.     Flag The sub-board flag tells 4D-BBS what type of message system the
  147. sub-board will have.  Below is a list of applicable flags.  The Name use
  148. rules ONLY apply to those systems allowing aliases to be used.  See
  149. Overview section for information concerning different sub-board types.
  150.  
  151.         FLAG SUB-BOARD TYPE NAME USE RULES
  152.  
  153.         Y Local Sub-Board Anonymous Names Allowed
  154.         N Local Sub-Board Anonymous Names Not Allowed
  155.         R Local Sub-Board Real Names Only
  156.         F Fido-Net Echo Real Names Only
  157.         M Fido-Net NetMail Real Names Only
  158.         U Use-Net Newsgroup Real Names Only
  159.         I Internet NetMail Real Names Only
  160.  
  161.     Low Mess Current low message for this sub-board.  Normally this is not
  162. edited, since it is calculated by the high message number minus the maximum
  163. number of messages.
  164.  
  165.     High Mess Current high message for this sub-board.  This value is
  166. stored in the "1.Msg" file (a Newsgroup uses a file named ".next") in the
  167. path specified above.  Normally this is not a changeable value, except in
  168. case the "1.Msg" (or .next) file is lost, you will need to re-enter this
  169. value, or the BBS will restart the numbering of messages at 2.
  170.  
  171.     Max Msgs When this number of messages is reached on this sub-board,
  172. the lowest message will be deleted after the new message is saved.  If
  173. storage space is ample, this number can be large.  This number should be
  174. set proportionate to the number of posts this sub-board receives.  On a
  175. high traffic sub-board the number should be larger to allow people to read
  176. all the messages.  For a Fido-Net sub-board (flags "M" and "F") the TOSSER
  177. is responsible for deleting messages, and 4D-BBS will NOT delete any old
  178. messages, NO MATTER WHAT this value is set to.  Newsgroups use an expire
  179. theory, where the messages are deleted after being on the system for a
  180. certain number of days.  4D-BBS will not delete messages on a Newsgroup
  181. sub-board.  This number should be an ESTIMATE of the amount of messages
  182. normally on the sub-board and will not reflect the ACTUAL number of
  183. messages.
  184.  
  185.     Max Lines When a user enters a message on this sub-board, this value
  186. dictates the maximum number of lines they are allowed to enter.  If your
  187. computer is low on memory, you can set this to a lower value to save
  188. memory.  The memory requirement is 99 bytes times this number (i.e.  200
  189. lines would require approximately 20k).
  190.  
  191.     Start Hour The time the sub-board opens up allowing users to read and
  192. write messages.
  193.  
  194.     Stop Hour The time which the sub-board will close and not allow any
  195. users to read and write messages.  If BOTH start and stop hour are set to
  196. "0", the sub-board will be open 24 hours a day.  A user with SysOp access
  197. overrides these 2 settings, and can always access the sub-board.
  198.  
  199.     Fido Adr For a sub-board type "F" or "M", this is the Origin system
  200. address which will be included in the message.  Normally this will be your
  201. system's MAIN Fido-Net address, unless this sub-board is linked into an
  202. alternate FTN compatible network (i.e.  Amiga-Net or Trek-Net).
  203.  
  204.     Status This is the status of the sub-board, and works in conjunction
  205. with the start/stop hour.  If the setting is closed or open, then the
  206. stop/start hour will predict which one is in effect.  A setting of Read or
  207. Write will limit a user to that one function, regardless if they have
  208. access to the other.  Finally, a status of hidden will not show the
  209. sub-board, regardless of a user's access.
  210.  
  211.     Newuser Acc A new user will receive this access for this sub-board.
  212. Possible flags are (N)None, (R)Read, (W)Write, (B)Both, and (S)Sub-Sysop
  213. (B+Delete).  CASE IS SIGNIFICANT; when a user's access is upper case then
  214. this sub-board is considered to be MASKED ON.  That means in a global scan
  215. situation, this sub-board WILL be checked.  It is suggested that networked
  216. sub-boards be defaulted OFF (lowercase letter).  This keeps new users from
  217. always scanning network sub-boards when they log on (and puts less
  218. wear-and-tear on your hard drive).  The user is prompted to set the masks
  219. when they logon as a new user, and can change them with the mask editor
  220. command.
  221.  
  222.     Member Acc Same as "Newuser Acc:" above, except this is the access
  223. given to the user for this sub-board when the user is validated from new
  224. user status to member status.
  225.  
  226. 5.3 Sets of Sub-Boards
  227.  
  228.     It is possible to have different sets of sub-boards.  This is
  229. accomplished using the menu command to load in an alternate sub-board data
  230. file.  However, there are problems associated with this.  The most
  231. significant is that there is no additional last read message pointers in
  232. the user file.  If multiple sets of sub-boards are required, you must
  233. MIRROR your sub-boards access requirements.  This problem will be resolved
  234. in upcoming V3.0.
  235.  
  236. 5.4 Menu Topology Setups
  237.  
  238.     The most common way to setup the message bases on a BBS is to have a
  239. separate menu off the main menu, which would contain all the necessary
  240. message base commands.  This is how the distribution disk is setup.
  241. Another popular setup is to integrate the message commands into the main
  242. menu.  This is basically a merge of the main menu and the message base menu
  243. described above.  A less commonly used, but interesting topology is the
  244. adventure setup.  In this setup each menu is its own sub-board area and
  245. file transfer area, simulating a small town, castle, or other "setting".
  246.  
  247.     As you can see, there are many possibilities you can take with the
  248. flexibility of 4D-BBS.  Your only limitation is your imagination and
  249. patience in designing and creating your masterpiece!
  250.  
  251. 5.4.1 The User Point of View
  252.  
  253.     You may give the user any combination of the following 7 commands.
  254. Many of the commands have multiple settings or work differently depending
  255. on the situation.
  256.  
  257. 5.5 Posting a Message Command
  258.  
  259.     Posting a message involves the user creating a message to be sent to
  260. either a specific user in the case of E-Mail, or to all users who have
  261. access to that particular sub-board in the case of public messages.  A
  262. person can also reply to another message written by a user.  This message
  263. is treated a little differently, as it will have a parent message, and the
  264. user will also be able to embed or quote parts of the original message in
  265. their own message.
  266.  
  267.     Whether posting a message, or replying to a message, the user will
  268. always see several prompts before actually entering the body of the
  269. message.  All prompts have defaults which can be accepted by pressing
  270. Return.  If the post is not a reply, the "Title:" field MUST be filled in,
  271. or the post will be aborted.
  272.  
  273.  
  274.  
  275. 5.5.1 Posting Options
  276.  
  277.     Below are the different types of prompts and their function a user can
  278. view while posting or replying to another message.
  279.  
  280.     Anonymous If the sub-board is setup to allow anonymous posting, this
  281. prompt will query the user whether they would like to post with an
  282. anonymous name or not.  Anonymous names always have an "*" preceding them
  283. to indicate it is NOT a true name.  Currently Fido-Net echos, Mail, and
  284. Newsgroups do not allow anonymous posters.  The default for this is the
  285. user's real name.
  286.  
  287.     To The name of the message recipient.  If the message is NOT a reply,
  288. the default for a public sub-board is "All", while the default for an
  289. E-Mail sub-board is the SysOp's name.  If the message is a reply, the
  290. default will be the name of the author of the message being replied to.  In
  291. the case of InterNet mail, this field will contain both the user name and
  292. the address (see the address field below for Fido-Net).  UseNet Newsgroups
  293. do not utilize this field, and therefore users will NOT be prompted for
  294. this when posting or replying on a UseNet Newsgroup.  4D-BBS does NOT check
  295. if the user name is valid, since it is possible to post a message to a user
  296. who is on another system.  It is up to the USER to insure the name is
  297. entered correctly.
  298.  
  299.     Address System's address of the user of the "To:" field.  This prompt
  300. will ONLY show up on a Fido-Net E-Mail sub-board.  If the message is a
  301. REPLY, the default will be the address of the author of the parent message.
  302. If this post is NOT a reply, the default will be for local delivery.
  303. 4D-BBS will try to decipher the address to find any faults which might
  304. possibly be in it, before accepting the address.  A Fido-Net address must
  305. have a ":" and "/" in it, with an optional "." (i.e.1:346/24 or
  306. 1:346/24.5).
  307.  
  308.     Title The title of the message being posted.  If the message is NOT a
  309. reply, pressing Return at this prompt will abort the message.  If the
  310. message is a reply, a "RE:" will be pre-appended to the title of the parent
  311. post (if it does not already start with one) and this will be the default.
  312. The user does have the option of changing this.
  313.  
  314.     Once the user has successfully completed these prompts, they will then
  315. be put into the message entry system to complete the message.  (Refer to
  316. section 5.9 for using the message entry system.)
  317.  
  318. 5.6 Reading Messages Command
  319.  
  320.     Reading messages in 4D-BBS is one of the most commonly used functions
  321. by users.  Whether it be by the global quick scan option, or by a single
  322. read command, the functionality is similar.  When talking about the read
  323. functions, the term "global read" will be used to reference a read by the
  324. menu command ":j" and the term "normal read" will be used to reference a
  325. read by the menu command ":p r".  (Refer to Chapter 8 for more information
  326. on the implementation and usage of these two menu commands.)
  327.  
  328. 5.6.1 Global Quick Scan
  329.  
  330.     The most popular type of reading messages by users is the "Global
  331. Quick Scan".  This is a function which will scan each sub-board the user
  332. currently has masked on, and check if there are new messages.  If there
  333. are, the BBS will put the user at a prompt allowing them to execute any of
  334. the message functions.  Once the user has read all the new messages on a
  335. particular sub-board (or has chosen to skip to the next sub-board without
  336. reading all the messages) the BBS will move onto the next masked sub-board
  337. until all have been checked.  This is a very easy way for users to read all
  338. the new messages.
  339.  
  340.     The Global Quick Scan is basically a stacked set of read commands.
  341. Refer to section 5.6.4 Read Commands below for more information on the
  342. specifics inside the Global Quick Scan.
  343.  
  344. 5.6.2 Continuous and Manual Read Modes
  345.  
  346.     There are two types of display modes:  manual or continuous.  In
  347. manual mode, the user is prompted after each message is displayed for the
  348. next command.  In continuous mode the user is never prompted for a command,
  349. and all messages will be displayed one after the other until the last
  350. message is displayed.  If the user is in a Global read mode and selects
  351. continue, the BBS will automatically go to the next sub-board and start
  352. displaying messages, until ALL sub-boards have been checked.  At any time
  353. during continuous mode the user can abort the display, in which they will
  354. be prompted to abort continuous mode.
  355.  
  356.     When a user has ANSI enabled, they can choose between normal read
  357. mode, and full screen read mode.  In full screen read mode the header
  358. information will be kept at the top of the screen, while the body of the
  359. message is scrolled underneath it.  The user's terminal must support the
  360. FULL set of ANSI commands in order for this to work.  Normal read mode will
  361. simply clear the screen before displaying each message and is slightly
  362. faster than full screen read mode.
  363.  
  364.     Continuous read mode is normally used when a user wants to capture all
  365. the messages into a file, and read them off-line.  ANSI Full Screen read
  366. mode is not recommended for continuous read mode.  ANSI normal read mode
  367. will NOT clear the screen before each post in continuous mode (it will
  368. clear the screen before each post in manual read mode), and is easier to
  369. read in a text file.  (Refer to the "C" command in section 5.6.4 for
  370. information on how to turn on continuous read mode.)
  371.  
  372. 5.6.3 Message Threading
  373.  
  374.     For all sub-boards except UseNet Newsgroups and InterNet E-Mail,
  375. message threading is also available.  The behavior of message threading is
  376. different depending on whether the user is in global read mode or normal
  377. read mode.  The below dependencies describe the behavior of message
  378. threading in the two situations and assume message threading is turned on.
  379. If message threading is NOT turned on, a linear read will be used, and
  380. threads will be ignored.
  381.  
  382.     In global read mode, the BBS will check to see if the message has a
  383. parent higher than the user's initial last read message.  If so, this
  384. message will NOT be displayed, since it should have been displayed already.
  385. If the message does not have a parent higher than the initial last read,
  386. the message will be displayed and then checked to see if it has a child
  387. message.  If a child message is found, that message will be displayed, and
  388. the BBS will keep following the thread, displaying each message as it goes
  389. along, until the end of the thread is found (a message without a child
  390. message).  At that point, the BBS will go to the message AFTER the original
  391. message, and this process will start all over again, until the highest
  392. message is reached.
  393.  
  394.     Normal read mode with threading is very similar to global read mode
  395. except for one slight difference:  Each thread is considered to be
  396. complete, and in order to display a message that is a part of a thread, the
  397. user will have to manually move into that thread.  If the user were to
  398. start reading at number x, then any threads which started below x WILL NOT
  399. be seen.  This is confusing to some users, and could possibly change in the
  400. future.
  401.  
  402.     The structure of message threads are linear, and NOT tree.  This means
  403. that replies are not necessarily linked to the specific message the user
  404. replied to, but are attached to the end of the thread.
  405.  
  406. 5.6.4 Read Commands
  407.  
  408.     The following is a list of commands which are available at a normal
  409. read prompt.  Some commands are not always available, while other commands
  410. can only be used by a SysOp or local user.
  411.  
  412.     A:  Read Message Again Will redisplay the last message the user
  413. viewed.
  414.  
  415.     B:  Back a message Will display the previously displayed message.  If
  416. threading is enabled, the threads will be searched, so using this command
  417. does not always mean going to the message number one below the current
  418. message.  This command can also be invoked by the "-" or Delete keys.
  419.  
  420.     C:  Continuous Read Mode Enables the continuous read mode.  The user
  421. can press a key at any time to abort this mode.  (Refer to section 5.6.2.)
  422.  
  423.     D:  Delete Current Message If the user's account level is "SysOp" or
  424. has "S" status for this sub-board or the author of the current message,
  425. they can use this command to delete the current message.  If this message
  426. is in the middle of a thread, the parent and child messages will be updated
  427. to point to the other, essentially removing this message from the thread.
  428.  
  429.     E:  Edit Current Message If the user's account level is "SysOp" or has
  430. "S" status for this sub-board or the author of the current message, they
  431. can use this command to edit the current message.  No changing to the
  432. header information is allowed from this.
  433.  
  434.     F:  Find a Message Allows a user to enter a search string, and the BBS
  435. will display any messages which contain the string in the header or the
  436. body of the message.
  437.  
  438.     H:  Help Displays the file "Text:ReadMsg.Help".  This is a list of all
  439. the read commands.  This command can also be invoked by the "?" key.
  440.  
  441.     I:  Read Individual Message Allows the user to jump to a certain
  442. message.  Entering "I" can be bypassed by just entering the actual message
  443. number at the prompt.
  444.  
  445.     J:  Jump to End of Thread In thread read mode, this will skip reading
  446. the current thread, and go to the next message not associated with the
  447. current thread.  The messages in the current thread which have NOT been
  448. read WILL NOT be displayed.
  449.  
  450.     L:  Local Save If the user's account level is "SysOp" or they are
  451. logged onto the BBS locally, they can use this command to save (or append
  452. if the file already exists) the current message to a text file.  The user
  453. is prompted for a file name and should enter the full path.  If just the
  454. filename is given the file will be saved in the directory the BBS was
  455. started in.
  456.  
  457.     M:  Send Private E-Mail Allows a user to send private E-Mail to the
  458. author of the current message.  It is treated as a "reply" so the user can
  459. quote any part of the original message.  The user can change the name and
  460. address if they wish to send E-Mail to a user other than the author of the
  461. current message.  Currently this message WILL ALWAYS be sent to sub-board
  462. 0.  This may change in the future to allow the user to select the
  463. destination sub-board.
  464.  
  465.     N:  New Messages This command will display the next unread message on
  466. the current sub-board.  In global read mode this is the same as pressing
  467. Return, unless the user jumped to a certain message.
  468.  
  469.     P:  Post a Message This will allow the user to enter a new message
  470. which is NOT associated with any other messages.  If the user wishes to add
  471. a message to the current thread, they should use the reply command listed
  472. below.  (Refer to section 5.5.)
  473.  
  474.     Q:  Quit Reading Messages Stop reading messages and abort the read
  475. command.  If in Global read mode this will abort reading ALL sub-boards.
  476. If the user just wants to skip this sub-board and go to the next, they
  477. should use the Skip command listed below.  In normal read mode this will
  478. end the reading of messages.
  479.  
  480.     R:  Reply to Current Message This command allows the user to add a
  481. message to the current thread.  The message will be added to the END of the
  482. thread, and NOT at the point where the user actually replied at.  (Refer to
  483. section 5.6.3.)
  484.  
  485.     S:  Skip Reading Messages This command will prompt the user if they
  486. would like to have all the messages on the current sub-board marked as
  487. read.  If the user is in Global read mode, they will then go to the next
  488. masked sub-board.  If they are in normal read mode, the command will
  489. return, as if the "Q" command above was selected.
  490.  
  491.     T:  Toggle Thread Reading Allows the user to select whether the BBS
  492. will display messages in thread sequence, or ignore the message threads and
  493. show in numerical sequence.
  494.  
  495.     W:  Who is the Author If the author is a local user and their account
  496. information is public, this command will display the user information about
  497. the author.  This is very similar to the ":5 w" menu command.
  498.  
  499.     Z:  Scan Message Headers This will give the user a listing of the
  500. titles and authors of the posts on the current sub-board.  (Refer to
  501. section 5.7.)
  502.  
  503.     &:  Forward Message This command allows a user to forward the current
  504. message to another sub-board.  If the user selects a mail sub-board, they
  505. can forward this message to another user via mail.  This command can also
  506. be used to forward a message which is on an inappropriate sub-board to the
  507. correct sub-board before deleting it from the inappropriate sub-board.
  508.  
  509.     /:  Status of Read Mode This command will display the status
  510. information about the read mode, including current/low/high messages, date
  511. and time, and current sub-board.
  512.  
  513.     ::  Toggle Display of Toggles the display of kludge lines for Fido-Net
  514.     Kludge Lines sub-boards.  These are lines which begin with "^A", and
  515. also include the "Seen-By:" and "Path:" lines at the bottom.  For UseNet
  516. this will display the entire header before displaying the body.
  517.  
  518.     !:  Print Current Message If the user's account level is "SysOp" or
  519. they are logged onto the BBS locally, they can use this command to print
  520. the current message to the "PRT:" port.  The format is the same as the
  521. local save command mentioned above.  No form feeds or padding line feed are
  522. printed, so it's up to the user to make sure the printer is ready.  If the
  523. printer is NOT ready, it can cause the BBS to hang until it is on-line.
  524. Use this command with caution when logged on from remote!
  525.  
  526.     <:  Jump to First Message Displays the first available message on the
  527. current sub-board.
  528.  
  529.     >:  Jump to Last Message Displays the last available message on the
  530. current sub-board.
  531.  
  532.     .:  Toggle Full Screen If ANSI is enabled, this will toggle full
  533. screen
  534.     Read Mode read mode.  (Refer to section 5.6.2.)
  535.  
  536.     +:  Mark Attached If the current message has a file attached with it,
  537.     File for Downloading the user can use this command to mark the file to
  538. download.  The file will be added to the mark list, and the user can
  539. download it with one of many download commands.  They can not however
  540. directly download the file.  This option will probably be available in the
  541. future.
  542.  
  543.     :  Go to Next Message If the user presses Space or Return, the next
  544. logical message will be displayed.  (Refer to section 5.6.3.)
  545.  
  546. 5.7 Scanning Messages Command
  547.  
  548.     When a user does not wish to read all the messages on a sub-board,
  549. this is an excellent command to use to check for any messages that interest
  550. the user.  This command is especially useful when reading networked
  551. sub-boards which have a high amount of traffic.  By using this command
  552. users can quickly and easily pick out messages to read without having to
  553. read all the messages.
  554.  
  555.     When first invoked it will display the lowest and highest number of
  556. messages on the current sub-board and by default which message it will
  557. start scanning at.  It defaults to starting at the last message read by the
  558. user on the current sub-board.  By pressing Return, the user can select the
  559. default or they can enter their own starting number.  The function will
  560. list up to the highest message on the current sub-board.
  561.  
  562. 5.8 Secondary Message Commands
  563.  
  564.     The following are descriptions of commands which don't directly
  565. manipulate messages but affect the way some of the direct commands
  566. function.
  567.  
  568. 5.8.1 Alter Masks
  569.  
  570.     This command affects the behavior of many functions associated with
  571. messages.  When a user sees a list of sub-boards, they will ONLY see the
  572. sub-boards which they have masked ON.  When they do a Global quick scan,
  573. only the sub-boards which are masked ON will be checked.
  574.  
  575.     When the user selects this command, they will be presented with a list
  576. of the sub-boards they have access to.  Any sub-board number preceded by an
  577. "*" denotes a sub-board which is masked ON.
  578.  
  579.     By selecting the CLEAR option, all sub-boards can be masked off.
  580. Similarly, by selecting the ALL options, all the sub-boards can be masked
  581. ON.  Entering a sub-board number will toggle just that sub-board.  By
  582. selecting NEXT or PREVIOUS, the user can see all of the sub-boards.
  583. Pressing Return will go to the next set of sub-boards, if there is one.  If
  584. the user wishes to abort the selection and use their original masks, they
  585. can select Quit, or they can select Save to update their masks with these
  586. new ones.
  587.  
  588. 5.8.2 Listing Sub-Boards
  589.  
  590.     When a user sees a list of sub-boards, they are presented with several
  591. pieces of information about each sub-board:
  592.  
  593.     00 Personal Mail Open 23 03:00 02:00 RWD 1:346/24
  594.  
  595.     The first column is the sub-board number, followed by the sub-board
  596. name.  Next is the status of the sub-board as set in the message base
  597. editor program (and is also changeable via ARexx).  Following the status is
  598. the number of hours the sub-board is open, with the starting and stopping
  599. hours.  Next to the stopping hour are 3 letters showing the access the user
  600. has (Read/Write/Delete).  Last is the network address of the sub-board, or
  601. a blank if it's local only.
  602.  
  603. 5.8.3 Change Current Sub-Board
  604.  
  605.     This command dictates which sub-board is current.  Many menu commands
  606. can be passed a "0" to specify the action should be performed on the
  607. current sub-board.  This also affects the two EICs which display the
  608. current sub-board number and name.
  609.  
  610.     Normally this command is used in a menu with an input type of "#".  In
  611. this case the user is allowed to enter the sub-board number directly
  612. without having to go through an intermediate prompt.  The ":k 0" command
  613. can still be used to prompt the user for the sub-board to be made current.
  614.  
  615. 5.8.4 Macros
  616.  
  617.     Users can store up to 2 macros within their user account.  These are
  618. character combinations that can be used in the message editor.  A common
  619. use of macros is for a signature line or two at the end of a message.  The
  620. macros are accessed via the Control-P+Q and Control-P+W commands.
  621.  
  622.     When the macro edit command is invoked, both macros are displayed and
  623. the user has the option of editing either of them, saving the changed
  624. macros into their user account, or aborting the macro edit.
  625.  
  626.     When creating a macro, the user can use any Control-P character
  627. combination to implement color and styles.  EICs are also accessible in
  628. macros.
  629.  
  630. 5.9 Message Entry System Command
  631.  
  632.     The message entry system allows you or your users to create messages,
  633. edit messages, and edit text files.  The current message entry system is a
  634. line editor.  This type of system is compatible with almost every terminal
  635. type, since it does not require any special type of terminal emulation to
  636. use it.
  637.  
  638.     Default parameter for the message entry system is 200 lines, with each
  639. line a maximum length of 72 characters.  The reason for the 72 character
  640. limit is to prevent a quoted post to go over the normal 79 character screen
  641. limit.  The maximum number of lines is configurable on a per sub-board
  642. basis, the edit defaults to 200 lines.
  643.  
  644.  5.9.1 Startup Actions
  645.  
  646.     The message entry system can have three different types of opening
  647. action:  reading in a message or text file, quoting a message, or starting
  648. a new message.
  649.  
  650.     If Edit a Message was selected, the message will be read into the
  651. entry system, and you will be able to start appending to the message.
  652. Editing can also be performed on the message at this point using the
  653. commands outlined in section 5.9.  This mode can also include editing a
  654. text file rather than a sub-board message.  If the file being edited is a
  655. message, you can not change the header information for the message.
  656.  
  657.     If you are reading messages and reply to a message, 4D-BBS will
  658. automatically display the parent message, to allow you to quickly include,
  659. or quote, the relevant part of the parent message in your reply.  This
  660. allows easy following of replies.  See the quote editor command for more
  661. information on this function.
  662.  
  663.     If you are posting a new message or creating a text file, you will
  664. simply be put into the message entry system, with a blank message.  You can
  665. either start typing your message, or use any of the editing commands
  666. described below.
  667.  
  668.  5.10 Entering the Message Command
  669.  
  670.     After you are in the message entry system, you can simply type your
  671. message.  The BBS will automatically word wrap your text, pressing Return
  672. is not necessary except to end a paragraph.
  673.  
  674.  5.11 Message Entry Command
  675.  
  676.     In order to access the message entry commands, you will need to bring
  677. up the command prompt.  This is accomplished by typing a "/" at the
  678. beginning of a line.  A command prompt will then appear, allowing you to
  679. enter a command letter.  Below is a list of commands, and descriptions of
  680. how they work.
  681.  
  682.     Note:  Some commands may be preceeded with a line number to specify
  683. which line the action should be performed on, without being prompted for
  684. it.  These commands are noted by preceeding them with a number sign.
  685.  
  686.      A:  Abort Message Entry Allows you to abort the message, deleting any
  687. changes to the message you have made.
  688.  
  689.      #D:  Delete a Line Allows you to delete a single line of text from
  690. the message.
  691.  
  692.     #I:  Insert Text Allows you to insert text before a certain line.
  693. Accessing any editing command will stop this mode, and return you to the
  694. normal append mode.
  695.  
  696.     #L:  List Message of Line Allows you to list the entire message, or if
  697. you preceed the command with a number, it will only list that line.
  698.  
  699.      N:  Toggle line Numbers When typing in a message, the editor can
  700. display line numbers at the beginning of each line to show you what line
  701. number you are currently on.  This option is defaulted to off.
  702.  
  703.     Q:  Quote Parent Message If you are replying to a message, this
  704. command will allow you to embed parts of the parent message into your
  705. message.  After displaying the parent message with line numbers, you will
  706. be prompted for the starting and ending lines.  The BBS will automatically
  707. put the initials of the users followed by a ">" before each line of quoted
  708. text.  You should only quote relevant parts of the parent message, and very
  709. rarely should you ever quote the entire message.
  710.  
  711.     S:  Save Message This will save the message.  If a text file, it will
  712. be saved as the specified filename.  If a message, the BBS system will
  713. assign an appropriate filename according to what message base the message
  714. is being saved into.
  715.  
  716.     T:  Try Again Start over editing or entering this message.  This
  717.  will delete any changes you have made (if any) and allow restart of the
  718. Editor.
  719.